home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / ecadmin.z / ecadmin
Encoding:
Text File  |  2002-10-03  |  7.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))                                                          EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      eeeeccccaaaaddddmmmmiiiinnnn - configure and control the global event counters
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      eeeeccccaaaaddddmmmmiiiinnnn [----aaaaDDDDllllMMMMrrrrTTTT] [----dddd event[,event...]]  [----eeee event[,event...]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      eeeeccccaaaaddddmmmmiiiinnnn may be used on systems with MIPS R1x000 processors to configure
  16.      the global event counters maintained by IRIX using the underlying
  17.      hardware event counter mechanisms.  The global event counters are
  18.      maintained on a system-wide basis, aggregated over all processes and for
  19.      all user and system mode execution.
  20.  
  21.      The _e_v_e_n_t arguments identify hardware-specific event counters.  These may
  22.      be either integers or mnemonic, case-insensitive names.  In conjunction
  23.      with the ----eeee option, a single _e_v_e_n_t specification of ???? (with appropriate
  24.      shell escape) will cause eeeeccccaaaaddddmmmmiiiinnnn to list all known event counters, and
  25.      then exit.
  26.  
  27.      The normal usage would be to enable global event counters with eeeeccccaaaaddddmmmmiiiinnnn
  28.      and then to monitor the event counters with eeeeccccssssttttaaaattttssss(1) or the Performance
  29.      Co-Pilot tools.
  30.  
  31.      The options to _e_c_a_d_m_i_n are as follows;
  32.  
  33.      ----aaaa   Enable aaaallllllll event counters; this is an abbreviation for using ----eeee with
  34.           all of the possible _e_v_e_n_t counters enumerated, or ----eeee **** (with
  35.           appropriate shell escape).
  36.  
  37.      ----DDDD   Turn on diagnostic output associated with the control operations.
  38.  
  39.      ----dddd   Disable event counting for the nominated _e_v_e_n_t counters.
  40.  
  41.      ----eeee   Enable event counting for the nominated _e_v_e_n_t counters.
  42.  
  43.      ----llll   List all event counters for which counting is currently enabled.
  44.  
  45.      ----MMMM   By default, event counting is not currently supported for systems
  46.           with a mixture of R1x000 processors,  i.e. R10000 and R12000 or
  47.           R10000 and R14000. The ----MMMM flag relaxes this restriction and allows
  48.           control for the subset of the event counters that have the same
  49.           interpretation across all processor types.  This option but should
  50.           only be used in controlled execution environments where the
  51.           integrity of the event counter values aggregated across processor
  52.           types can be guaranteed.  Great care should be be exercised when
  53.           interpreting the counter values under these circumstances.
  54.  
  55.      ----rrrr   Disable (and release the allocation for) all global event counters.
  56.  
  57.      ----TTTT   The ----TTTT (or ``trust me'') flag disables the semantic checks for
  58.           combinations of event counters are normally not allowed on systems
  59.           with mixtures of processors of different type and/or revision.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))                                                          EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))
  71.  
  72.  
  73.  
  74.           Extreme care should be used with the ----TTTT flag, as the reported event
  75.           counter values maybe meaningless unless the execution environment is
  76.           very tightly controlled.  To have the desired effect, ----TTTT may require
  77.           the concurrent specification of the ----MMMM flag.
  78.  
  79.      If the operation is completed without errors, eeeeccccaaaaddddmmmmiiiinnnn has an exit status
  80.      of zero.
  81.  
  82. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  83.      The underlying hardware event counters are a finite resource, to be
  84.      shared amongst multiple competing uses.
  85.  
  86.      If there is any concurrent use of the process-based event counters via
  87.      either ppppeeeerrrrffffeeeexxxx(1) or the counter-based SpeedShop profiling tools, then
  88.      attempts to manipulate the global event counters via eeeeccccaaaaddddmmmmiiiinnnn will not
  89.      succeed.  Processes using the process-based event counters can be
  90.      identified with eeeeccccffffiiiinnnndddd(1).
  91.  
  92.      If global event counting is enabled via eeeeccccaaaaddddmmmmiiiinnnn then this will augment
  93.      any concurrent use resulting from an earlier use of eeeeccccaaaaddddmmmmiiiinnnn.
  94.  
  95.      Once aaaannnnyyyy global event counters have been enabled with eeeeccccaaaaddddmmmmiiiinnnn, then any
  96.      future attempts to use either ppppeeeerrrrffffeeeexxxx(1) or the counter-based SpeedShop
  97.      profiling tools will be unsuccessful, until aaaallllllll global event counters are
  98.      released, either with ----rrrr or by disabling all active counters via ----dddd.
  99.  
  100.      For this reason, the user of eeeeccccaaaaddddmmmmiiiinnnn must be rrrrooooooootttt to use any option other
  101.      than ----llll or ----eeee ????.
  102.  
  103.      Depending on the revision of the MIPS R10000 CPUs there is a difference
  104.      in the interpretation of event counter 14 (``Virtual coherency
  105.      condition'' for parts before revision 3.1 or ``ALU/FPU completion
  106.      cycles'' for parts at revision 3.1 or later).  There are also some subtle
  107.      differences in the semantics of some of the event counters.  In systems
  108.      with a homogeneous deployment of R10000 CPUs at the same revision,
  109.      eeeeccccaaaaddddmmmmiiiinnnn will adjust the description of event counter 14 accordingly.
  110.  
  111.      For systems with a mixed deployment of R10000 CPU revisions including
  112.      some before 3.1 and some at or after 3.1, the interpretation of event
  113.      counter 14 is undefined, and there may be some slight inaccuracies due to
  114.      aggregation of counters with different semantics across all CPUs.  For
  115.      this reason counter 14 may not be enabled on systems with mixed R10000
  116.      reployments unless the ----TTTT flag is specified.
  117.  
  118.      Identification of the types and revisions for all CPUs can be made using
  119.      the ----vvvv flag to hhhhiiiinnnnvvvv(1), or the ----DDDD flag to eeeeccccaaaaddddmmmmiiiinnnn.
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      eeeeccccffffiiiinnnndddd(1), eeeeccccssssttttaaaattttssss(1), ppppeeeerrrrffffeeeexxxx(1), ppppmmmmiiiinnnnffffoooo(1), ssssppppeeeeeeeeddddsssshhhhoooopppp(1) and
  123.      rrrr11110000kkkk____ccccoooouuuunnnntttteeeerrrrssss(5).
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))                                                          EEEECCCCAAAADDDDMMMMIIIINNNN((((1111))))
  137.  
  138.  
  139.  
  140.      The specifications for the MIPS R10000 event counters may be found at
  141.      http://www.sgi.com/processors/r10k/performance.html
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.